Collapse All Expand All

Prizm Document Converter (PDC) installation is designed to be very straightforward for Linux environments. Follow the steps provided in this section.

Some steps may be specific to a particular Linux distribution; these steps will be labeled as being specific to one of the following: 

• "Red Hat / Fedora (CentOS) Linux Distributions"
• "Debian (Ubuntu) Linux Distributions"

Step 1 - Download Prizm Document Converter

1. Download the appropriate package for your distribution by going to:
   http://www.accusoft.com/prizmdocconverterdownload.htm

   Packages are only available for 64-bit systems.

Step 2 - Unpack & Install the Downloaded Archive

Open a command line and change to the location where you downloaded the tarball. Use the following command line examples appropriate for your distribution to:

1. Decompress and unpack the downloaded file. After you have unpacked the archive, the contents will have been decompressed into a directory named "prizmcc_<version>_rpm(or _deb)". 

2. Change to the unpacked directory and install the packages.

   Red Hat, Fedora, CentOS, and Older Linux Distributions

   Example	Copy Code
   # tar –xzvf prizmdc_<version>_rpm.tar.gz  # cd prizmdc<version>_rpm  # yum install –nogpgcheck *.rpm

   Debian (Ubuntu) Linux Distributions

   Example	Copy Code
   # tar –xzvf prizmdc_<version>_deb.tar.gz  # cd prizmdc<version>_deb  # sudo dpkg –i *.deb  # sudo apt-get –f install

   Generic .tar.gz Distribution

   We also provide a generic .tar.gz package. You will need to install the dependencies described in the Requirements section. Once the dependencies are installed, you can install the .tar.gz with the following commands as root:

   Example	Copy Code
   # tar -xzvf prizm-documentconverter*.tar.gz  # tar -xzvf prizm-services*.tar.gz  # cp -R prizm /usr/share/

Step 3 - Configure

1. Continuing as root, change to the installation location: /usr/share/prizm and run setup.sh. This will run the Prizm Licensing Utility (PLU) and configure PDC for its first run:

   setup.sh launches the Prizm Licensing Utility (PLU), which is a GUI application. Depending on how you have X11 configured, you might need to run 'xhost +' as the logged in user to allow the PLU launched by the root user to access X11. You can disable X11 access for root by executing 'xhost –' when you are done.

   Example

   Copy Code

   # ./setup.sh Select the type of license you want to acquire:                 1) Evaluation [e]                 2) Deployment [d]             Choose 1 or 2: d             Select the type of deployment license you have:                 1) Node Locked [n]                 2) OEM         [o]             Choose 1 or 2: o             Provide the solution name: PDC10             Provide the OEM license key provided to you: 2.0...             Your deployment license was acquired successfully.             ./scripts/pccis.sh start             Starting Prizm Content Connect Information Services...             Starting Nginx process...             Starting PCCIS Watchdog process...             PCCIS Watchdog has been started correctly.             ./scripts/demos.sh start             Starting Content Conversion Service Demo...             Starting Demo Service process...             Demo Service has been started correctly.

2. For a production installation, you will want to configure where log files are stored and ensure that Nginx logs are rotated and pruned. See the section How to Configure Log File Locations. 

Step 4 - Verify That the Installation Was Successful

1. Browse to the following either via URL or through a browser:
   http://localhost:18681/admin

   You should receive a response like this:

   Example

   Copy Code

   {"serviceStatus":"running","licenseStatus":"licensed as 'PCC10'","instances":[{"serviceStatus":"running","pccisVersion":"10.0.1027.926","runtimeVersion":"4.0.30319.34209","operatingSystem":"Microsoft Windows NT 6.1.7601 Service Pack 1","startTime":"2015-03-25T16:49:07.7736670Z","instanceId":"EXAMPLE","childServices":[ {"name":"PCC Imaging Proxy Server","serviceStatus":"running","version":"10.0.1027.0780"} , {"name":"PCC Imaging Conversion Service","serviceStatus":"running","version":"1.3.0027.0529"} , {"name":"PCC Vector Conversion Service","serviceStatus":"running","version":"2.1.0027.0561"} , {"name":"PCC Raster Conversion Service","serviceStatus":"running","version":"2.2.0027.0631"} , {"name":"PCC Work File Service","serviceStatus":"running","version":"0.1.0"} , {"name":"PCC Redaction Service","serviceStatus":"running","version":"0.1.0"} , {"name":"PCC Office Conversion Service","serviceStatus":"running","version":"1.1.0027.0164"} , {"name":"PCC AutoRedaction Service","serviceStatus":"running"} , {"name":"PCC Content Conversion Service","serviceStatus":"running"} , {"name":"PCC Format Detection Service","serviceStatus":"running"} ]}]}

Step 5 - Configure on CentOS 5.x

PDC will not work on a CentOS 5.x system with the default LibreOffice. For this purpose you need to download and install LibreOffice from libreoffice.org as described below:

1. Install the latest stable version of LibreOffice for your OS. Download and install it from this location: http://www.libreoffice.org/download
2. Follow LibreOffice Installation instructions from this location: http://www.libreoffice.org/get-help/installation/linux/

   LibreOffice Desktop Integration for Linux is not needed; you do not need to complete those steps.

   The LibreOffice installation might fail if you have LibreOffice or any other application already listening on any of the following ports: 18580, 18584, 18585, 18586, 18590, 18591, 18592, 18593, 18680. By default, Prizm Document Converter installs the proxy service on port 18680 and uses 3 of the following ports for conversion purposes: 18580, 18584, 18585, 18586, 18591, 18592, 18593. You can add more ports as your traffic increases.

3. Locate root folder of your LibreOffice installation. The LibreOffice is usually located in the following directory: /opt/libreoffice4.x
4. Edit <prizm-install>/conf/proxyserver_jar.properties and change following parameter to fit the root location of LibreOffice:

   Example	Copy Code
   Office Document converter installation base directory #odc_installation=/usr/share/prizm/libreoffice odc_installation=/opt/libreoffice4.3

5. Change the watchdog.config OCS officeInstallPath to point to a community version of LibreOffice. By default this value is:

   	Copy Code
   "officeInstallPath":"../libreoffice/program"

   or

   	Copy Code
   "officeInstallPath":"/usr/share/prizm/libreoffice/program"

   Example of fixed path:

   	Copy Code
   "officeInstallPath":"/opt/libreoffice4.4/program"

6. Save proxyserver_jar.properties, restart Prizm service, and check proxyserver.log to make sure PDC uses the installed LibreOffice.

Step 6 - Installation Complete

Your installation is now complete. You can view the status of the Prizm Platform Services at http://localhost:18681/admin.

How to Install Common Certificate Authority Root Certificates on Linux

The following commands should all be run as root. Additionally, if prompted for addition/removal permission, then yes/no should be entered as the response.

1. Install all Mozilla's root certificates. This command will install all the root certificates Mozilla accepts, prompting only to remove certificates that Mozilla doesn't list, adding all it does trust without prompt. This should make HTTPS work for any system that Firefox works with:

   Example	Copy Code
   /usr/share/prizm/mono/64/bin/mozroots --machine --import --ask-remove

2. Pull certificates from an https connection to accept:

   Example	Copy Code
   /usr/share/prizm/mono/64/bin/certmgr -ssl -m https://servertoadd

   As long as the server includes the entire chain to root, this will allow the certificate to authenticate. This will generally be the case for self-signed test certificates. For more complex situations, any required items from the chain will need to be added manually.

3. Manually add the certificate from the file:

   Example	Copy Code
   /usr/share/prizm/mono/64/bin/certmgr -add -c -m /path/to/certificatefile

   The certificate stores the certificates at: /usr/share/.mono/certs/.

 

 

---

©2015. Accusoft Corporation. All Rights Reserved.

Send Feedback